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MEETING NOTICE 


Our meeting will be held at 1:00 p.m., July 9, 1977, at the Waukesha 
Technical Institute (Room 202 - Administration Building). 


PROGRAM AGENDA 

Club member Todd L. Voros will be our Main Speaker. The topic of his 
lecture will be SKETCHCODE - a programming technique devised by Todd. 
If you can, please study the article on SKETCHCODE in this Newsletter 
before the meeting. It could help you to better understand this new 
programming technique when presented at our meeting. 

CLUB MEMBERSHIP DUES COLLECTION 


Membership for the last 6 months of 1977 is $3.00. This will be the 
last Newsletter for those who have not paid membership fee. 


Send your $3.00 membership fee to: 

Donald Stevens 

P.O. Box 159 

Sheboygan Falls, Wisc. 53985 
CLUB QUESTIONAIRE 


I have not received many of the completed questionaires enclosed in the 
June Newsletter. BRING IN THESE QUESTIONAIRES TO THE JULY MEETING. 
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FOR SALE ----------+-+-+-+-e-- Contact Don Stevens 


One (1) MB6A Solid State Music RAM Board - 8K Board 


Two (2) MB2 Solid State Music RAM Boards - 4K Boards. 


Note: These boards are made for S-100 Buss and are top quality boards. 
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Please be advised of the opening of the Madison Computer Store, 1919 
Monroe Street, Madison, Wisc. 53711. Huron Smith is store Manager. 
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The AMIDE Corporation of ‘New York announces availability of a PDP-8 


simulator for the 8080. Priced around $20.00 and available in Paper 
Tape or Tarbell Cassette 


Pere Te TS TT TTT TTT TTT TCT TTT TEE TET TTT T TTT Tere 
Heath Kit announces availability of 

8080 Based System ($375 including Octal Keyboard) & compatible peripherals 
LSI-11 Based System ($1295.00) & compatible peripherals 


Paper Tape Reader/Punch - reads at 50 characters per second and punch 
operates at 10 characters per second ($395) 


Photos available at JULY MEETING 
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Centronics announces Compact Microprinter - 240 characters per second 
and priced at $595.00 
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FREE FREE ATTENDANCE PRIZE COPIES OF JULY COMPUTER NOTES from MITS 
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GOOD THINGS TO READ 
Computer Design - June 1977 
| Microcomputer Interfacing: Interfacing a 10-Bit DAC 
A Task Scheduling Executive Program for Microcomputer Systems 
Analysis of Multiple Microprocessor System Architectures 
EDN - JUNE 1977 
Chapters 1 thru 13 of Software Design Course (paqes 67 thru 200) 
Electronic Design - June 7, 1977 
Getting the bugs out of your Software 
Interface Circuit that teams cassette recorder with a CRT to work 


as a TTY/papertape unit 


IEEE CIRCUITS & SYSTEMS - Feb. 1977 

A simple Cassette Interface 
IEEE SPECTRUM - May 1977 

Everybody's Doing It ('computing' at home) 
IEEE SPECTRUM - April 1977 


Analog tests: The microprocessor scores 
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A DOCUMENTATION TECHNIQUE FOR HOME COMPUTER HOBBYISTS AND PROGRAMMERS 


By: Todd L. Voros ; 
Systems Software Specialist 
A.O. Smith Corporation 
Data Systems Division 
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Problem: How can we keep from rewriting the same code over and over 
again for different computers? 


Problem: How can we help our colleagques understand our programs 
quickly and efficiently? 


Problem: How can we simplify and ease the debugging of our programs? 
Answer: SKET CHCODE 
Sketchcode? Sketchcode is a documentation technique, that if properly 
used can save time and effort when coding in any computer 
language. 
—_What it is not: Sketchcode is not flowcharting. 
Sketchcode is not a language. 
Sketchcode is not hard to learn, 


What dt ass To answer this question, let us ask ourselves, 
“What are programs made of?" 


Program: An implementation of one or more algorithms intended to 
solve a problem expressed in a machine digestible form. 


What are algorithms composed of? 


Processes that do not require decisions 
Decisions 


What is the normal method of documenting an algorithm for computer 
implementation? A: Flowcharting. 


Does sketchcode replace Flowcharting? No, it compliments it. 


So what is sketchcode? 
Sketchcode is an individualistic, stylistic pseudo - 


lanquage expressing the logical flow of control through 
a program through the use of certain elementary structures. 


shat are these elementary structures? 
Things like: Loops 
Decisions 


Indentation of Logical Levels of Control 


How do we express a loop in Sketchcode? 
We write: DO WHILE (an expression); 
PROCESSING 
END; ; 
Note PROCESSING is indented two blanks to the right. All other 
sketchcode processing within that loop will be indented two blanks to 


(an expression) is the evaluation of any number of variables we desire 
resulting in the assignment of a TRUEor a FALSE condition. 


While the condition remains true, we execute statements inside the loop. 


If the condition is false, we do not execute any statements in the loop; 
we proceed to begin executing the statement after the END; which tells 
us where the loop ends. This is why the END; is not indented two columns 


to the right like PROCESSING. 


How can we get out of a sketchcode DO loop? 


By having PROCESSING within the loop change the value of 
the variables tested by (an expression). 


An example? Execute some processing 10 times: 
COUNT = 0 
DO WHILE (COUNT less than 10); 
PROCESS 
COUNT = COUNT + 1 
END; 


Of course, the expression that is tested for TRUE or FLASE could be 
much more complex: 


DO WHILE (I =3*X OR Q=7*SQRT(35.2-E)); 
And of course, we can put a loop inside a loop: 
DO WHILE (I less than 10) 
PROCESS 


DO WHILE (J more than 12) 
a, MORE PROCESSING 


MORE PROCESSING 
END; ! 


END; 


Notice each DO has it's own closing END statement. 


“Now if you think about this form of representation of the logical flow 

of a program for a moment or two, you may begin to see how some fairly 
complex situations involving loops inside of loops could be clearly and 
consisely expressed. Also note that the inner DO loop was indented two 
columns to the right and processing performed under it's control was itself 
indented two columns to the right. Beta 


Thus; ‘The deeper a loop is (the more nested it is in the logical flow 
of control of the program), the further to the right it will appear 
in the program's Sketchcode representation. 


Also; Code that is indented to the far riqht will probably be executing 
the most often by your program. Therefore, concentrate your 
optimizing efforts there first (if you make any such efforts). 


However, programs are not composed entirely of loons, although they play 
a very imnortant part of programming. 


Decisions are also of prime importance in directing the flow of control 
of a program. In Sketchcode, a decision is always represented as a 
elementary structure of the form: 

IF (expression) 


THEN DO; 
PROCESSING for TRUE expression 


ELSE; 


PROCESSING for FALSE expression 


Notice, for readability that the THEN DO; and the ELSE; are indented two 
columns to the right and their corresponding processing is itself indented 
two columns further right. 


Since (an expression), is always true or false in Sketchcode, either 
the processing under the THEN DO; will be executed and the processing 
under the ELSE; will be skipped, or the processing under the THEN DO; 
will be ignored and the processing under the ELSE; will be executed. 


Sometimes in the flow of control of a program there occurs the situation 
that some processing is to be done only if some condition is true; otherwise 


nothing is to be done. This would tend to create a dangling ELSE; so | 
Sketchcode allows the convention that a decision can also take the form: 


IF (expression is true) 
THEN; 
PROCESSING 
without a closing ELSE; condition. However, if the condition being 


evaluated by the IF is false, all processing indented to the right of 
the THEN; is ignored. 


Sometimes loops in a program are effectively never-ending. To handle 
this special case, Sketchcode permits a special form of the DO loop 


notation: 


DO FOREVER; 
PROCESSING 
END; 


An example of 'DO FOREVER' miqht be where we wish the computer to read 
data from the teletype forever and process it, give us an answer, and 
await further input. This could be done as follows: 


DO FOREVER; 


READ INPUT 
PROCESS INPUT 


END; 


Sometimes we wish to perform once-only initialization inside of a loop 

in our programs. This would seem difficult to represent in Sketchcode 

notation but is actually not. Taking a combination of DO and IF simple 
structures, we are able to build a SWITCH STRUCTURE: 


INITSW = ‘initialize' 
DO WHILE (an expression) ; 


IF (INITSW = ‘initialize) 
THEN DO; 
PERFORM INITIALIZATION PROCESSING 
SET INITSW = ‘don't initialize' 
ELSE: 
PERFORM NORMAL PROCESSING 


END; 


The only tricky point to the above example is that the first time 
through the above example, INITSW (our initialize/don't initialize 
switch) will be set to ‘initialize’ so the THEN DO; leg of the 

IF will be executed on the first pass through the DO loop. Since 
the last thing the initialization processing does is to set the 
initialization switch to ‘don't initialize', when performing the 
2nd through last pass through the DO loop, the code under the ELSE; 
branch of the IF will be executed!! Thus, we have managed to 
provide a method of once-only initialization inside of a DO loop. 


_.Notice we did not forget the closing END;, and of course keep in 
nind that both the initialization and normal processing could have 
deeper levels of DO's and IF's imbedded within them. ! 


Now, what is the point we are attempting to make? The structures we 
_ have defined are completely adequate for expressing any problem capable 
of being implemented on a hobbyist home microprocessor system. 


So what? Well, then so what is this?: WHERE WERE THE GOTO STATEMENTS?? 
(OR JUMPS, OR BRANCHES IF YOU PREFER) 


Answer: There aren't any in Sketchcode. 


Program logic always flows from top to bottom, through various 
levels of indentation on the way. 


Program loops are always clearly documented. 


Sketchcode forces you to provide a clear, concise definition 
of what you are trying to do, yet permit individualistic style 
to be used (our own examples certainly aren't part of any 
'LEGAL' programming language). 


When a program's logic is done in Sketchcode, it is easier 
to follow and debug. 


If your algorithm is written in Sketchcode, it can easily be 
written for another, perhaps totally different microprocessor. 


And last, but not least, if you really want to make your 
programs self-documenting, include your program's Sketchcode 
as part of the COMMENTS in the assembly language version of 
your program if you are writing it in an assembler. However, 
no matter what the language, Sketchcode assists in providing 
better documentation and insight into your efforts. 
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Brief Commentary: 


A few hints from the author on the use and writing of Sketchcode follow 
from his experience in working with it for the last two years: 


1. If you find yourself writing a lot of IFP-THEN-ELSE, IF-THEN-ELSE 
clustered together in your Sketchcode, ask yourself the question: 
"Is this reallv a DO loop in disquise?" 

2. Remember that all IF's do not necessarily require an ELSE! 


3. Don't forget to indent when going to a deeper level of control!! 


4. Remember that Table Searches are usually implemented by DO's. 
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5. Processing performed under the leqs of an IF (the THEN DO and the ELSE) 
can be switched by negating the results of (an expression). 


Thus, rE (X = 0) 
THEN DO; 

A=B 

ELSE; 
A=B+B 


is the same as 


IF (X not equal 0) 
THEN DO; 
A=B+B 
ELSE; 
A=B 


6. This point is tricky, but is worth consideration if your Sketchcode 
somehow doesn't ‘seem right': 


If the FLSE condition of the IF can be qotten to by some other code 
prior to the IF test, then it is NOT an ELSF condition. Remove the 
ELSE and the indentation of code under the ELSE. - 


7. Before you begin to write down the very first machine or assembly 
Tangquage statement of your program, have the completed Sketchcode of 
your program in front of you and code your voroqram from the Sketchcode!!! 


8. Ask others to review your Sketchcode if you are working on a complex 
task. 
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The following Proqram was written by Tom Doyle and has been in use in 

my 8080 System which has a Diqital Group TV Readout and Cassette Interface. 
The Video interface supports 512 characters (32 characters by 16 lines) on 
my Video ‘fonitor. 


This program for automatic Scroll resides on Page 054 in my System. The 
buffer area assiqned in this proqram must occupy the top 512 bytes of an 
area in memory where you have no memory for at least 32 bytes above it. 

Program can be relocated most any place in memory as long it adheres to 

above conditions. My Video Output Port is 064. 


SCROLL ROUTINE FOR VIDEO READOUT --------------~-~- by Tom Doyle 
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0540007 3685 PUSH PSW 
0540017 328 PUSH D 
0540027 345 PUSH H 


054003/ 376 CPI 015 Is it a carriage return 
054005/ 312 JZ 054044 

0540107, 376 CPI 012 Is it a line feed 
054012/ 312 JZ 054050 

054015/ 376 CPI 177 Is it a TAB DELETE 
O540!17/ 312 Jz 054056 

054022/ 376 CPI 010 Is it a backspace 
054024/ 312 Jz 054064 

054027/ 376 CPI 137 Is it.an "_"  Underscore 
0540317 312 JZ . 054064 f, 

054034/ 376 CPI OTA ys x, TRE OOP oo. - CONTROLDAL 
054036/ 312 JZ 054056 j 

O54041/ 315 CALL .' 054127 Call Input 


054044/ 341 POP H 
0540457 .321 POP D 
OS4046/ 361 POP PSW 
0840477 311 RET 


054050/ 3!5 CALL 054207 Call Scroll #@#—————Line Feed 
054053/ 303 JMP 054044 

054056/ 315 CALL 054332 Call Clear Screen «»———TAB 
0540617 303 JMP 054044 ORE VERS ema 
054064/ 076 MVI A 040 par 8% ~ Backspace 
054066/ 052 LHLD 055376 Bottom Less 2 We 
O54071/ 167 MOV MA 

054072/ 043 INX H 

054073/ 167 MOV MA 

054074/ 042 SHLD © 055376 ~- Bottom Less 2 

054077/ 315 CALL - 054173 . Call Print 

054102/ O04! LXI H 057375 Top Less 2 

054105/ 315 CALL 054153 Call Move Cursor 

0541107 315 CALL 054317 Call Print Cursor , 

054113/ 303 JUMP 054044 ~=Jump Out 

O54116/ 076 MVI ee & = Home Up 
054120/ .323 OUT 064 Video Port 

054122/ 076 MVI A 000 , 

054124/ 323 OUT 064 

054126/ 311 RET 

054127/ O52 LHLD 055376 Bottom Less 2 qdiee———— Input 
054132/ 167 MOV MA ? af 

0541337 315 CALL 054173 Call Print 

054136/ 315 CALL 05435@ +. Call EOB (End of Buffer) 

O54141/ 332 JC 054207 JC Scroll 

O54144/ O53 DCX H 

054145/ 042 SHLD 055376 Bottom Less 2 

054150/ 303 JMP 054312 Jump Cursor ; 

054153/ 076 MVI A oo! —Q—————————Move Cursor 
054155/ 323 OUT 064 

OS4157/ O76 MVI A 000 

054161/ 323 OUT - 064 

0541637 315 CALL 054352 Call EOB: 


0541667 330 RC 


054170/ 303 JMP 054153 Jump for Next Byte y 
——— Print 


054176/ 
054200/ 
0542027 
054204/ 
0842067 
0542077 
0542127 
054215/ 
0542 16/ 
084217/ 
0542227 
054225/ 
054226/ 
054227/ 
054232/ 
054235/ 
054237/ 
054240/ 
0842437 
084246/ 
054247/ 


' 0842527 


054255/ 
0542607 
0542617 
054264/ 
054267/ 
054272/ 
054278/ 
054276/ 
0543017 
054304/ 
054307/ 
054312/ 
0543147 
054315/ 
054316/ 
0543177 
0543217 
054324/ 
0843277 
054332/ 
054335/ 
0543377 
0543407 
0543437 
054346/ 
054347/ 
054352/ 
0543537 
054356/ 
054357/ 
054360/ 
054363/ 
054364/ 
054365/ 
054370/ 
0543717 
054374/ 


0543757 


054376/ 
0543777 


306 
323 
076 
323 
311 
041 
021 
176 
022 
315 
332 
053 
033 
303 
041 
076 
167 
315 
332 
053 
303 
315 
041 
176 
315 
315 
332 
053 
303 
041 
042 
041 
315 
333 
007 
330 
000 
076 
315 
041 
303 
041 
076 
167 
315 
332 
053 
303 
325 
021 
174 
272 
302 
175 
273 
302 
067 
303 
067 
O77 
321 


“311 


ox oProx 


Kc ie a 
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Lie 


200 
064 


“ 000 


064 


057377) 
060037 


054352 
054232 


084215 
0$6037 
040 


054352 


054252 


054235 
054116 
087377 


054173 
054352 
054276 


054260 
056037 


055376 . 


057337 
054153 
377 


137 

054173 
057376 
054153 


057377 


040 


054352 
054252 


054335 


056000 
054374 


054374 


054376 


Jump for Next Byte 


“Call Print 


Top ‘eiilbceise ced Scroll 1 Line 


Top + 32 ¥ 
Call EOB - 


Start of Bottom Line o—itteae Botton | 
Line 


Call EOB 


_ Jump for Next Byte 


Call Home Up 


‘Top of Memory Area 


Se nan ween apres a eneeretapansaetgls carte naaitaenne—iinnars ate 
eens eaten 


Call EOB 


Jump for Next Byte 

Bottom + 32 Reset 

Bottom less 2 C putter Pointer 
Top less 32 a— Move to 

Call Move Cursor ‘© Lower Left 
Input Sense Switches 


Move ASCII " " Print Cursor 
Call Print — =—{ symbol 

Top less 1 : Advance 

Jump to Move Cursor Counter 

Top of Memory Area «——Fill Buffer wit! 
‘Move ASCII So , Spaces. 


Call Check for Bottom a Buffer 


Bottom of Memory Area 


